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Chapter  1 


Preface 


In  this  chapter: 


Typographical  Conventions 5 

Feedback 6 


Typographical  Conventions 

Before  you  start  using  this  guide,  it  is  important  to  understand  the  documentation 
conventions  used  in  it. 

The  following  kinds  of  formatting  in  the  text  identify  special  information. 

Formatting  convention  Type  of  Information  Example 


Special  Bold 

Items  you  must  select, 
such  as  menu  options, 
command  buttons,  or 
items  in  a list. 

Go  to  the  System  tab. 

Titles  of  chapters, 
sections,  and  subsections. 

Read  the  Basic 
Administration  chapter. 

Italics 

Used  to  emphasize  the 
importance  of  a point,  to 
introduce  a term  or  to 
designate  a command  line 
placeholder,  which  is  to  be 
replaced  with  a real  name 
or  value. 

The  system  supports  the 
so  called  wildcard 
character  search. 

Monospace 

The  names  of  commands, 
files,  directories,  and 
domain  names. 

The  license  file  is  located 
in  the 

http : //docs /common/ 
licenses  directory. 

6 Own6Ka!  Hcnojib3yMTe  BKnaflKy  TnaBHaa"  ajib  npHMeHeHna  Heading  1 k TeKCTy,  KOTopbm  flo/weri  3flecb 

OTo6pa>KaTbCB. 


Pre format ted 


Preformatted 

Bold 


On-screen  computer 
output  in  your  command- 
line sessions;  source  code 
in  XML,  C++,  or  other 
programming  languages. 

What  you  type,  contrasted 
with  on-screen  computer 
output. 


# Is  -al  /files 

total  14470 


# cd  /root/rpms/php 


CAPITALS 


Names  of  keys  on  the  SHIFT,  CTRL,  ALT 
keyboard. 


KEY+KEY  Key  combinations  for  CTRL+P,  ALT+F4 

which  the  user  must  press 
and  hold  down  one  key 
and  then  press  another. 


Feedback 


If  you  have  found  a mistake  in  this  guide,  or  if  you  have  suggestions  or  ideas  on  how  to 
improve  this  guide,  please  send  your  feedback  using  the  online  form  at 
http://www.parallels.com/en/support/usersdoc/.  Please  include  in  your  report  the 
guide’s  title,  chapter  and  section  titles,  and  the  fragment  of  text  in  which  you  have 
found  an  error. 
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About  This  Guide 


This  guide  provides  instructions  on  upgrading  Parallels  H-Sphere  3.5.1  to  version 
3.6.3.  If  you  have  an  earlier  version,  you  need  to  upgrade  to  3.5.1  first. 
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Preparing  for  Parallels  H-Sphere  Upgrade 


Before  you  start  upgrading  Parallels  H-Sphere  to  version  3.6.3,  please  obtain  a license 
for  this  version,  as  you  will  need  it  to  access  the  upgraded  Control  Panel. 

As  both  MySQL  and  PostgreSQL  are  updated  in  Parallels  H-Sphere  3.6.3,  it  is  strongly 
recommended  that  you  back  up  all  databases  hosted  in  MySQL  and  PostgreSQL:  all 
user  databases  on  database  servers,  Control  Panel  database  on  Control  Panel  server. 

In  a straightforward  and  simple  approach  it  can  be  done  with  the  following  shell 
commands: 

For  FreeBSD: 

# stop 

/usr/local/etc/rc . d/apachecp . sh  stop  # actual  only  for  CP  server,  but 
no  problem  to  run  it  everywhere 
/usr/local/etc/rc . d/010 .pgsql . sh  stop 
/usr/local/etc/rc . d/mysql- server  stop 

cp  -pR  /var/db/mysql  /var/db/mysql -backup  # you  can  specify  other 
destination  directory 

cp  -pR  /usr/local/pgsql  /usr/local/pgsql-backup  # you  can  specify 
other  destination  directory 

# start 

/usr/local/etc/rc . d/mysql -server  start 
/usr/local/etc/rc . d/010 .pgsql . sh  start 

/usr/local/etc/rc . d/apachecp . sh  start  # actual  only  for  CP  server,  but 
no  problem  to  run  it  everywhere 

For  RedHat: 

# stop 

service  httpdcp  stop  # actual  only  for  CP  server,  but  no  problem  to 
run  it  everywhere 
service  postgresql  stop 
service  mysql  stop 

cp  -pR  /var/lib/mysql  /var/lib/mysql-backup  # you  can  specify  other 
destination  directory 

cp  -pR  /var/lib/pgsql  /var/lib/pgsql-backup  # you  can  specify  other 
destination  directory 

# start 

service  mysql  start 
service  postgresql  start 

service  httpdcp  start  # actual  only  for  CP  server,  but  no  problem  to  run  it  everywhere. 
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Upgrading  Parallels  H-Sphere 


To  upgrade  Parallels  H-Sphere,  please  perform  the  steps  provided  in  this  chapter. 

In  this  chapter: 


Step  1.  Updating  Parallels  H-Sphere  Control  Panel  Core 9 

Step  2.  Starting  Control  Panel  Apache 10 

Step  3.  installing  a new  License 10 

Step  4.  Updating  Physical  Boxes 10 

Step  5.  Starting  ImageMaker 13 

Step  6.  Checking  the  Version  of  Parallels  H-Sphere 13 


Step  1.  Updating  Parallels  H-Sphere 
Control  Panel  Core 

> To  update  Parallels  H-Sphere  CP  core: 

1.  Download  H-Sphere  updater: 

# wget 

http: //download. hsphere .parallels . com/ shiv/HS /releases /U3 6 . 0/U36 . 0P2/U 
36.0P2 

2.  Run  the  installation/update  script: 

# sh  ./U36.0P3 

You  will  see  a help  window  with  a prompt  to  enter  update  options. 

3.  Update  Parallels  H-Sphere  core  (templates,  classes,  jars): 

cpupdate  [OPTIONS] 

> To  finalize  update  of  Parallels  H-Sphere  CP  core: 

1.  Set  PostgreSQL  service  automatically  startable  on  Linux: 

# chkconfig— levels  2345  postgresql  on 


Step  2.  Starting  Control  Panel  Apache 

Parallels  H-Sphere  update  script  will  automatically  launch  Parallels  H-Sphere  CP  after  the 
update.  Check  if  Parallels  H-Sphere  is  running,  and  if  not,  start  CP  Apache: 

Linux: 

# /etc/rc . d/init . d/httpdcp  start 

FreeBSD: 

# /usr/local/etc/rc . d/apachecp . sh  start 


Step  3.  installing  a new  License 

1.  Log  in  to  the  Control  Panel  as  administrator. 

You  will  be  prompted  to  enter  new  license  activation  code. 

2.  Enter  the  code. 

Now  you  can  log  out  from  Control  Panel,  unless  you  are  going  to  update  physical  boxes 
using  it. 


Step  4.  Updating  Physical  Boxes 

You  have  two  options  for  updating  Parallels  H-Sphere  packages  on  physical  boxes: 

■ Option  1 . From  the  Control  Panel  (it  is  the  only  option  available  for  Windows  boxes). 

■ Option  2.  From  the  command  line  by  running  the  installation/update  script  (on  page  38). 

After  Parallels  H-Sphere  packages  are  updated,  please  finalize  update  on  physical  boxes 
carrying  database  servers. 

In  this  section: 


Option  1 . Updating  Physical  Boxes  from  the  Control  Panel 1 1 

Option  2.  Updating  Physical  Boxes  from  Command  Line 12 

Finalizing  update  of  Physical  Boxes  carrying  Database  Servers 12 


Option  1.  Updating  Physical  Boxes  from  the  Control  Panel 


> To  update  Parallels  H-Sphere  on  selected  physical  servers: 

1 . Go  to  E.Manager  > Update  > Update  Boxes. 

2.  Check  the  servers  you  need  to  update. 

3.  If  necessary,  you  can  get  info  about  the  box  by  checking  boxes  and  clicking 
the  Fetch  Boxes  Info  button. 

4.  Click  Start  Update. 

Update  process  indicator  legend: 

■ Yellow,  ready  for  update 

■ Blue:  update  is  running 

■ Green:  update  successfully  finished 

■ Red:  update  finished  with  error.  If  update  fails,  you  will  see  an  error  message  with  details. 

> Peculiarities  of  Parallels  H-Sphere’s  work  on  Windows  2008  x64  and  Windows 
2008  R2  x64 

Please  consider  the  following  when  you  intend  to  upgrade  Parallels  H-Sphere  on  Windows 

2008  x64  and  Windows  2008  R2  x64  servers  from  versions  earlier  than  3.6.3: 

■ PHP  5.5  is  built  with  VC1 1 (Visual  Studio  201 2 compiler)  and  includes  improvements  in 
performance  and  stability.  For  the  VC1 1 builds,  the  Visual  C++  Redistributable  for  Visual 
Studio  2012  x64  http://www.microsoft.com/en-us/download/details. aspx?id=30679  has  to 
be  installed. 

■ PHP  5.4  is  built  with  VC9  (Visual  Studio  2008  compiler)  and  includes  improvements  in 
performance  and  stability.  For  the  VC9  builds,  the  Visual  C++  Redistributable  for  Visual 
Studio  2008  SP1  x86  http://www.microsoft.com/en-us/download/details. aspx?id=5582 
has  to  be  installed. 

> Peculiarities  of  Parallels  H-Sphere  work  on  Windows  2003 

Please  consider  the  following  when  you  intend  to  upgrade  Parallels  H-Sphere  on  Windows 

2003  servers  from  versions  earlier  than  3.6.3: 

■ PHP  5.4  is  built  with  VC9  (Visual  Studio  2008  compiler)  and  includes  improvements  in 
performance  and  stability.  For  the  VC9  builds,  the  Visual  C++  Redistributable  for  Visual 
Studio  2008  SP1  x86  http://www.microsoft.com/en-us/download/details. aspx?id=5582 
has  to  be  installed. 


Option  2.  Updating  Physical  Boxes  from  Command  Line 

Run  the  installation/update  script: 

# $ sh  ./U36.0P3 

• To  update  Parallels  H-Sphere  and  Parallels  SiteStudio,  type: 

update  [OPTIONS] 

■ To  update  only  Parallels  H-Sphere,  enter: 

hsupdate  [OPTIONS] 

■ To  update  only  Parallels  SiteStudio,  enter: 

sitestudio  [OPTIONS] 

Important:  If  you  have  a non-standard  setup  of  Parallels  H-Sphere,  please  refer  to  Appendix 
F.  Parallels  H-Sphere  Update  and  Installation  Script.  You  can  refer  to  it  also  for  details  on  the 
above  mentioned  options. 


Finalizing  update  of  Physical  Boxes  carrying  Database 
Servers 

For  the  Linux  based  physical  boxes  carrying  PostgreSQL  servers,  set  PostgreSQL  service 
automatically  startable: 

# chkconfig— levels  2345  postgresql  on 

For  the  physical  boxes  carrying  MySQL  server,  perform  databases  upgrade: 

# mysql_upgrade  -v  -u  USER  -p 

# mysqlcheck  -o  -A  -a  -r  -u  USER  -v  -p 

where  value  to  specify  instead  of  USER,  and  the  corresponding  password  - could  be  read 
from  file  -mysql/.my.cnf  on  this  physical  box. 


Step  5.  Starting  ImageMaker 

Start  ImageMaker  if  your  Parallels  H-Sphere  is  integrated  with  Parallels  SiteStudio,  for  Linux 
and  FreeBSD: 

# /hsphere/shared/SiteStudio/imaker . sh  start 


Step  6.  Checking  the  Version  of  Parallels  H- 
Sphere 

Check  the  version  of  Parallels  Pi-Sphere  by  executing  the  following  command  on  your  CP 
box: 

# cat  ~cpanel/shiva/psof t_config/HS_VERSION 

You  will  see  a line  similar  to  this: 

HSJ/ERSION  = <HSphere-branch>.<HSphere-build> 

Where: 

<HSphere-branch>  is  the  version  of  Parallels  Pi-Sphere 
<HSphere-build>  is  the  Parallels  Pi-Sphere  build 
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Post-Upgrade  Issues 


Please  contact  support  at  http://www.parallels.com/support/hsphere/  and  inform  them 
about  the  upgrade.  This  is  required  to  get  appropriate  support  from  Parallels.  Also 
make  sure  you  meet  the  following  requirements: 

1.  Customization.  If  you  have  custom  Parallels  H-Sphere  templates,  you  may 
probably  need  to  update  them  according  to  changes  introduced  in  this  version. 
More  in  the  section  Template  Customization  of  Parallels  H-Sphere  Customization 
Guide. 

2.  Ownership.  In  Parallels  H-Sphere  HTML  pages,  images,  Javascript  and  CSS  files 
and  respective  directories  have  cpanei rhttpdcp  ownership.  Parallels  H-Sphere 
updater  checks  and  automatically  sets  correct  ownership  and  permissions  on 
respective  default  and  custom  files  and  directories.  Please  make  sure  however  that 
newly  created  custom  files  have  correct  ownership  and  permissions  (this  does  not 
relate  to  Parallels  H-Sphere  packages). 

3.  VPS:  After  you  have  updated  Parallels  H-Sphere,  please  also  make  sure  you  run 
Steps  3-8  of  the  Parallels  H-Sphere  VPS  update  instruction.  For  this,  refer  to  the 
section  Updating  Parallels  H-Sphere  Virtual  Private  Servers  of  Adding  New  H- 
Sphere  Servers  and  Services  guide. 

4.  DBD::mysql  Perl  driver.  If  you  want  to  update  DBD::mysql  driver  or  system  Perl 
version,  make  sure  to  execute  the  script  that  updates  DBD::mysql  driver  as 
described  at  http://hsphere.parallels.com/misc/socket  location  mvsql  server.html. 

5.  Set  up  Kronolith  Reminders:  If  you  use  Kronolith  reminders,  make  sure  to  set 
them  up  according  to 

http://wiki.horde.orq/KronolithReminders?Horde=b80c80a948f71e51023fe0c5d758 

47bc&referrer=HowTo. 
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Appendix  A.  Supported  Operating 
Systems 


Before  requesting  Parallels  H-Sphere  installation,  make  sure  to  install  one  of  the 
following  operating  systems: 


Operating  System 

Supported  OS  Version 

RedHat  Enterprise  Linux 

5.x  (1386,  x86_64) 

6.x  (1386,  x86_64) 

CentOS 

5.x  (1386,  x86_64) 

6.x  (1386,  x86_64) 

CloudLinux 

5.x  (1386,  x86_64) 

6.x  (1386,  x86_64) 

FreeBSD 

7.4  (1386,  amd64) 

8.3  (1386,  amd64) 

8.4  (1386,  amd64) 

Important: 

1 . We  claim  Parallels  H-Sphere  support  on  WhiteBox  OS,  assuming  it  is  a RedHat 
Enterprise  Linux  clone.  However,  we  do  not  test  Parallels  H-Sphere  on  WhiteBox 
servers. 

2.  FreeBSD:  Control  Panel  installed  on  a server  with  64-bit  operating  system  requires 
glibc  32-bit  compatibility  library. 

3.  CloudLinux  is  supported  as  a RedHat  Enterprise  Linux  clone.  The  customizations 
allowed  by  it  are  not  propagated  to  Ul,  and  should  be  performed  manually  according  to 
instructions  published  on  the  CloudLinux  site,  if  needed. 

4.  Red  Hat  Enterprise  Linux  4.x  and  its  clones  are  supported  since  3.6.0  SPU  53  for 
migration  purposes  only. 
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Appendix  B.  HDD  Partitioning 


Parallels  H-Sphere  is  installed  to  the  /hsphere  directory. 

We  recommend  dedicating  a separate  partition  for  the  Parallels  H-Sphere  installation 
directory  and  mount  it  as  /hsphere. 

# mkdir  -p  /hsphere 

# chmod  755  /hsphere 

Parallels  H-Sphere  directory  can  be  located  on  any  other  partition  as  well.  However,  we 
do  not  recommend  installing  Parallels  H-Sphere  to  the  root  / partition.  Having  Parallels 
H-Sphere  on  the  root  partition  may  cause  certain  problems.  For  instance,  if  disk  quota 
gets  damaged,  you  cannot  repair  it  without  server  reboot  and  f sck  check  in  the  single 
user  mode. 

If  your  Parallels  H-Sphere  installation  directory  is  to  be  located  on  another  partition,  for 
example,  /usr/hsphere  on  the  / usr  partition,  the  /hsphere  symlink  to  this 
directory  must  be  anyway  created: 

# mkdir  -p  /usr/hsphere 

# In  -s  /usr/hsphere  /hsphere 

# chmod  755  /usr/hsphere 


Important:  Do  not  create  /hsphere  as  a symlink  to  another  partition  on  servers  with 
FreeBSD  5.3  and  up.  Allocate  the  separate  /hsphere  partition  instead.  If  this  is 
impossible,  use  the  nuiif  s partitioning  for  this  purpose. 


There  are  no  more  requirements  to  partitioning  the  servers,  just  make  sure  there  is 
enough  disk  space  to  store  user  and  other  Parallels  H-Sphere  data. 
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Appendix  C.  Customizing  Server 
Configuration  Files  by  Means  of 
Templates 


You  cannot  customize  some  major  service  configuration  files  (for  Web,  mail,  DNS, 
databases)  directly,  as  your  changes  in  these  files  will  be  overwritten  with  a 
consequent  Parallels  H-  Sphere  update!  Instead,  you  need  to  create  configuration  file 
templates  by  means  of  the  hsphere-update  wrapper  and  customize  these  templates 
instead  of  default  configuration  files. 

You  can  customize  configuration  file  templates  by  means  of  Parallels  H-Sphere 
updater,  provided  you  have  not  customized  your  templates  already.  For  this  purpose 
two  new  options  are  added  to  the  hspackages  wrapper  of  the  Parallels  H-Sphere 
update  script: 

■ hspackages  ctempiates=  [options ] - Place  custom  templates  for  comma- 
separated  list  of  services  into  predefined  locations  if  custom  templates  are  not  there 
already. 

■ hspackages  edit=IP : /path/ to/ custom/ template  - Edit  custom  template 
on  a specified  server  in  a specified  location. 


Important: 

If  you  run  the  hspackages  ctemplates  command  without  options,  it  will  create  custom 
templates  on  all  related  servers  of  the  Parallels  H-Sphere  cluster!  To  specify 
particular  servers  where  custom  configuration  templates  should  be  created,  please 
use  the  extended  syntax  of  the  hspackages  command.  For  example,  to  create  PHP 
custom  configuration  templates  only  on  the  physical  boxes  1 92.1 68.1 .1 0 and 
192.168.1.11,  run: 

hspackages  ctemplates=php  ips=192 . 168 . 1 . 10, 192 . 168 . 1 . 11 

The  hspackages  ctemplates  command  should  be  run  only  once,  in  order  to  create 
custom  configuration  templates!  Then  you  customize  these  files  according  to  your 
needs.  Next  time  you  run  it,  it  will  prompt  re-creating  your  custom  configuration 
templates,  thus  you  may  lose  your  customization! 

The  only  exclusion  when  you  need  to  run  hspackages  ctemplates  again  is  when  a 
coming  version  of  the  hsphere-update  package  contains  updates  of  default 
configuration  templates.  You  will  be  specially  notified  of  this  in  the  respective  update 
notes. 


In  this  chapter: 
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Extra  Apache  Configuration  Files 21 


18  Oujn6Ka!  l/lcnonb3yMTe  BKJiaflKy  TjiaBHaa"  flna  npuMeHeHna  Heading  1 k TeKCTy,  KOTopbm  flon>KeH  3flecb 
OTo6pa>KaTbca. 


PHP  4 22 

PHP  5 23 

PHP  5.3 24 

PHP  5.4 25 

PHP  5.5 25 

Standardized  PHP 27 

FTP 27 

MySQL 29 

PostgreSQL 29 

DNS 30 

Other  Files  Included  into  Parallels  H-Sphere  Packages 31 


Own6Ka!  l/lcnonb3yMTe  BKnaflKy  TnaBHaa"  flna  npnMeHeHna  Heading  1 k TeKdy,  KOTopbiii  flOJweH  3flecb  OTo6pa>KaTbCfl.  19 


Control  Panel  Apache 

Default  Control  Panel  Apache  httpd.conf  template  is  included  into  the  hsphere- 
update  and  installed  here: 

/hsphere/pkg/ scripts /templates/ cpapache/httpd . conf . tmpl .default 


> To  customize  the  template: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download. hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=httpdcp  option: 
hspackages  ctemplates=httpdcp  [OPTIONS] 

Custom  template  will  be  placed  into  the  following  location: 

/hsphere /local /home/ cpanel /apache/ etc/httpd. conf . tmpl . custo 
m 

1.  Edit  the 

/hsphere/ local /home/ cpanel / apache /etc/httpd. conf. tmpl 
. custom  file  according  to  your  needs. 

2.  To  immediately  apply  changes,  run  the  conf  file  generating  script  which 
is  as  a rule  executed  in  the  postinstall  section  of  the  package: 

/hsphere/ shared/ scripts /apache- re start 


Extra  Control  Panel  Apache  Configuration 
Files 


Parallels  H-Sphere  allows  to  customize  some  extra  Apache  configuration  files  for 
Control  Panel.  They  are  located  in  the 

/hsphere/local/home/ cpanel/ apache/conf / extra/  directory: 

■ httpd-autoindex . conf  - directives  controlling  the  display  of  server-generated 
directory  listings 

■ httpd-cache . conf  - directives  providing  HTTP  content  cache  configuration 

■ httpd-inf  o . conf  - Apache  status-related  directive  blocks 
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■ httpd-ianguages . conf  - directives  which  provide  the  mod  mime  and 
mod_negotiation  modules  global  configuration 

■ vh-ss l-defauit . conf  - Global  SSL  default  VirtualHost  configuration 

These  extra  configuration  files  are  provided  for  easier  configuration  of  Apache 
modules,  such  as  mod_cache,  mod_security,  etc. 

After  the  configuration  file  customization,  the  correspondent  * . tmpi . custom  files  will 
be  created  in  the  same  directory: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=httpdcp_extra 
option: 

hspackages  ctemplates=httpdcp_extra  [OPTIONS] 

After  that,  custom  templates 

/hsphere /local /home/  cpanel/  apache /conf/  extra  / * . tmpl . custom  will 
be  created. 

2.  Edit  the 

/hsphere/ local /home/ cpanel / apache /conf/extra/* . tmpl . c 
ustom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  Apache: 

/hsphere/ shared/ scripts/apache-restart 


Apache 

Default  configuration  Apache  templates  are  included  into  the  hsphere-update 
package  and  installed  in  the  following  locations: 

/hsphere/pkg/ scripts/ template s/hs- 
31/ apache /httpd . conf . tmpl .default 
/hsphere/pkg/ scripts/ template s/hs- 
31/ apache/httpd2 . conf . tmpl . default 
/hsphere/pkg/ scripts/ template s/hs- 
31apache/lsrv . conf . tmpl .default 


> To  customize  them,  perform: 
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1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctemplates=httpd  option  for 
Apache  1 .3  and/or  ctempiates=httpd2  option  for  Apache  2.2: 

hspackages  ctemplates=httpd  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  locations: 

/hsphere /local/ conf ig/httpd/lsrv . conf . tmpl . custom 
/hsphere/local/ conf ig/httpd/httpd. conf . tmpl . custom 
/hsphere /local/ conf ig/httpd2 /lsrv . conf . tmpl . custom 
/hsphere/local/ conf ig/httpd2 /httpd . conf . tmpl . custom 

2.  Edit  the  . custom  files  according  to  your  needs: 

/hsphere/local/ conf ig/httpd/lsrv . conf . tmpl . custom 
/hsphere/local/ conf ig/httpd/httpd . conf . tmpl . custom 

3.  To  immediately  apply  changes,  run  the  conf  file  generating  script  which 
is  as  a rule  executed  in  the  postinstall  section  of  the  package: 

/hsphere/ shared/ scripts /apache- re start 

Customizing  /hsphere/shared/apache/htdocs/index.html 

If  you  need  to  leave  /hsphere/ shared/apache/htdocs/ index  . html  unchanged 
after  the  update,  create  the  following  file: 

touch  /hsphere/ local/ conf ig/httpd/ index . html . custom 

If  the  latter  file  exists,  then  you  can  customize  your  index . html  file  without  the  risk  of 
its  being  overwritten. 


Extra  Apache  Configuration  Files 

Parallels  H-Sphere  allows  to  customize  some  extra  Apache  configuration  files,  such  as: 

■ httpd-autoindex . conf  - directives  controlling  the  display  of  server-generated 
directory  listings 

■ httpd-cache . conf  - directives  providing  HTTP  content  cache  configuration 
(Apache  2.2  only) 

■ httpd-gzip . conf  - directives  for  global  settings  provided  by  the  mod_gzip 
module  (Apache  1 .3  only) 

■ httpd-inf  o . conf  - Apache  status-related  directives 
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■ httpd-ianguages . conf  - directives  which  provide  the  mod_mime  and 
mod_negotiation  modules  global  configuration 

■ httpd-security.  conf  - ModSecurity  configuration  options 

■ httpd-security2  . conf  - ModSecurity  v.2  configuration  options  (Apache  2.2 
only) 

■ vh-ssi-de fault . conf  - global  SSL  default  VirtualHost  configuration 

Default  templates  * . tmpi . default  for  these  configuration  files  are  installed  with 
hsphere-updater  to  the  following  directories: 

Apache  1.3: /hsphere/pkg/scripts/templates/hs- 
31/ apache /extra .default/ 

Apache  2.2:  /hsphere/pkg/scripts/templates/hs- 
31/ apache /ext ra2 . default/ 

After  Parallels  H-Sphere  3.2  update,  the  respective  custom  . tmpi . custom  files  will  be 
created  in  the  following  directories: 

Apache  1.3: /hsphere/local/config/httpd/extra/ 

Apache  2.2:  /hsphere/local/config/httpd2/extra/ 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http: //download. hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctemplates=httpd_extra 

option: 

hspackages  ctemplates=httpd_extra  [OPTIONS] 

After  that,  custom  templates  * . tmpi . custom  will  be  created  in  respective 
directories. 

2.  Edit  the  * . tmpi . custom  files  according  to  your  needs: 

Apache  1.3:  /hsphere/local/conf ig/httpd/extra/* . tmpi . custom 
Apache  2.2:  /hsphere/ local/ conf ig/httpd2 /extra/* . tmpi . custom 

3.  To  immediately  apply  changes,  restart  Apache: 

/hsphere/ shared/ scripts/apache-restart 


PHP4 


PHP  4 configuration  files  are  located: 
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/hsphere/ local/ conf ig/httpd/php4/php . ini . tmpl . custom  (when  PHP4 
uses  fastcgi,  for  all  Apache  versions) 

/hsphere/local/ conf  ig/httpd/php4/php . ini  . tmpl . custom  (when  Iibphp4 
is  used,  for  Apache  1.x) 

/hsphere/local/ conf  ig/httpd2/php4  /php  . ini  . tmpl . custom  (when  Iibphp4 
is  used,  for  Apache  2.x) 

> To  customize  PHP  4 configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http: //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=php  option: 
hspackages  ctemplates=php  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  location: 

/hsphere/local/ conf ig/httpd2 /php 4 /php . ini . tmpl . custom 

/hsphere/local/ conf ig/httpd/php4 /php . ini . tmpl . custom 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 


PHP  5 


PHP  5 configuration  files  are  located: 

/hsphere/local/ conf ig/httpd/php5/php . ini . tmpl . custom  (when 
PHP5  uses  fastcgi,  for  all  Apache  versions) 

/hsphere/local/ conf ig/httpd/php5/php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  1.x) 

/hsphere/local/ conf ig/httpd2/php5/php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  2.x) 

> To  customize  PHP  5 configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 
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# wget 

http : //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=php  option: 
hspackages  ctemplates=php  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  location: 

/hsphere/local/ config/httpd/php5/php . ini . tmpl . custom 
/hsphere /local/ conf ig/httpd2 /php5/php . ini . tmpl . custom 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 


PHP5.3 


PHP  5.3  configuration  files  are  located: 

/hsphere/local/ conf ig/httpd2/php53  ts/php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  2.x  and  mpm_worker) 

/hsphere/local/ config/httpd2/php53/php.  ini  . tmpl . custom  (in  all  Other 
cases) 

> To  customize  PHP  5.3  configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

a.  Download  H-Sphere  updater: 

# wget 

http: //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

b.  Run  the  update  script: 

# sh  ./U36.0P3 

C.  Execute  the  hspackages  wrapper  with  the  ctemplates=php 
option: 

hspackages  ctemplates=php  [OPTIONS] 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  the  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 
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PHP  5.4 


PHP  5.4  configuration  files  are  located: 

/hsphere/ local/ conf ig/httpd2/php5  4 ts/php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  2.x  and  mpm_worker) 

/hsphere/local/ config/httpd2/php54/php.  ini  . tmpl . custom  (in  all  Other 
cases) 

> To  customize  PHP  5.4  configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

a.  Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

b.  Run  the  update  script: 

# sh  ./U36.0P3 

C.  Execute  the  hspackages  wrapper  with  the  ctemplates=php 
option: 

hspackages  ctemplates=php  [OPTIONS] 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  the  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 


PHP  5.5 


PHP  5.5  configuration  files  are  located: 

/hsphere/local/ conf ig/httpd2/php55  ts/php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  2.x  and  mpm_worker) 

/hsphere/local/ config/httpd2/php55/php.  ini  . tmpl . custom  (in  all  Other 
cases) 

> To  customize  PHP  5.5  configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

a.  Download  H-Sphere  updater: 
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# wget 

http : //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

b.  Run  the  update  script: 

# sh  ./U36.0P3 

C.  Execute  the  hspackages  wrapper  with  the  ctemplates=php 
option: 

hspackages  ctemplates=php  [OPTIONS] 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  the  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 
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Standardized  PHP 


Standardized  PHP  configuration  file  is  located: 

/hspher e / shar ed/php - 

internal /conf/php . ini . tmpl . custom 

> To  customize  standardized  PHP  configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

a.  Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

b.  Run  the  update  script: 

# sh  ./U36.0P3 

C.  Execute  the  hspackages  wrapper  with  the  ctemplates=php 
option: 

hspackages  ctemplates=php  [OPTIONS] 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  the  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 


FTP 


FTP  configuration  file  templates  are  included  into  the  hsphere-update  package  and 
installed  in  the  following  locations: 

/hsphere /pkg/ scripts /templates /pro ftpd/ shared. prof tpd. con f . tmpl . 
default 

/hsphere /pkg/ scripts /templates /pro ftpd/ lo cal. prof tpd. conf. tmpl . d 
ef ault 


> To  customize  these  templates,  perform: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 
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# wget 

http : //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=ftpd  option: 
hspackages  ctemplates=f tpd  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  locations: 

/hsphere /local/ con fig/ f tpd/prof tpd . conf . tmpl . custom 
/hsphere/ shared/ conf ig/ ftpd/proftpd. conf . tmpl . custom 

2.  Edit  the  . custom  files  according  to  your  needs: 

/hsphere /local/ config/ ftpd/proftpd. conf. tmpl . custom 
/hsphere/ shared/ config/ ftpd/proftpd . conf . tmpl . custom 

3.  To  immediately  apply  changes,  run: 

/hsphere/ shared/ config/ f tpd/ conf igure-prof tpd . sh 

4.  Restart  FTP  service. 
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MySQL 

MySQL  configuration  file  templates  are  included  into  the  hsphere-update  package  and 
installed  in  the  following  locations: 

Linux: /hsphere/pkg/ scripts /templates /FreeBSD/my . cnf  tmpl .default 
FreeBSD: /hsphere/pkg/ scripts/templates/Linux/my . cnf  tmpl . default 


> To  customize  these  templates,  perform: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=mysqi  option: 
hspackages  ctemplates=mysql  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  location: 

/hsphere /local/ conf ig/mysql/my . cnf  tmpl . custom 

2.  Edit  the  /hsphere/ local /conf ig/mysql/my . cnf_tmpl . custom 

file  according  to  your  needs. 

3.  To  immediately  apply  changes,  run  the  conf  file  generating  script  which 
is  as  a rule  executed  in  the  package  postinstall  section: 

/hsphere /local /conf ig/mysql/ scripts /conf ig_mysql 


PostgreSQL 

PostgreSQL  configuration  file  templates  are  included  into  the  hsphere-update  package 
and  installed  in  the  following  locations: 

Linux: 

/hsphere/pkg/ scripts/ templates/FreeBSD/postgresql . conf  tmpl . defa 
ult 

FreeBSD: 

/hsphere/pkg/ scripts/templates/Linux/postgresql . conf  tmpl . def aul 
t 


> To  customize  these  templates,  perform: 
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1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http: //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=pgsqi  option: 
hspackages  ctemplates=pgsql  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  location: 

/hsphere /local/ conf ig/pgsql/postgresql . conf  tmpl . custom 

2.  Edit  the 

/hsphere/ local/ config/pgsql/postgresql. conf_tmpl .oust 

om  file  according  to  your  needs. 

Important:  By  default,  PostgreSQL  listens  on  localhost  (parameter 
virtual_host=1 27.0.0.1  in  configuration  file).  Change  this  parameter  if  required. 

3.  To  immediately  apply  changes,  run  the  conf  file  generating  script  which 
is  as  a rule  executed  in  the  package  postinstall  section: 

/hsphere /local /conf ig/pgsql/ scripts /conf ig_pgsql 


DNS 

/etc/named.conf 

Default  template  is  located  at 

/hsphere/pkg/ scripts/ templates /named/ named. conf . tmpl .default 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctemplates=named  option: 
hspackages  ctemplates=named  [OPTIONS] 

Custom  template  will  be  placed  into  the  following  location: 

/etc/named.conf  .tmpl. custom 
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2.  Edit  the  /etc/named . conf . tmpl . custom  file  according  to  your 
needs. 

3.  To  immediately  apply  changes,  run  the  configuration  file  generating 
script  which  is  as  a rule  executed  in  the  postinstall  section  of  the 
package: 

/hsphere/ local/ conf ig/bind/ scripts/ conf ig_bind 

/etc/resolv.conf 

To  leave  /etc/resoiv.  conf  unchanged  during  the  update  (e.g.,  when  MyDNS  is 
used),  perform: 

touch  /etc/resolv.conf .custom 

If  the  latter  file  exists,  then  you  can  customize  your  /etc/resoiv . conf  file  without 
the  risk  of  its  being  overwritten. 


Other  Files  Included  into  Parallels  H- 
Sphere  Packages 


Warning:  It  is  not  recommended  that  you  customize  the  files  included  into  Parallels  hl- 
Sphere  packages  by  yourself.  Any  alterations  made  to  them  are  at  your  own  risk! 


Besides  customization  of  some  major  service  configuration  files  (for  Web,  mail,  DNS, 
databases,  etc.),  we  have  implemented  for  your  convenience  a possibility  to  customize 
other  files  included  into  Parallels  H-Sphere  packages.  For  this,  we  have  created  a 
configuration  file  /hsphere/local/ config/customs/ customs  . conf  and  a 
Special  template  /hsphere/local/ conf  ig/ customs/ customs  . conf  . tmpl  that 
will  help  you  to  save  customized  Parallels  H-Sphere  packages  files  during  future 
updates. 

> To  customize  a file  included  into  Parallels  H-Sphere  Package  and  save  the 
changes: 

1.  Make  necessary  changes  to  the  file  you  want  to  customize. 

2.  Copy  a template  of  custom  files  to  a configuration  file: 

cp  -p  /hsphere/local/ conf ig/cus toms/customs .conf . tmpl 
/hsphere/ local/ conf ig/ customs /customs . conf 

3.  Go  to  the  customs . conf  file 

4.  Add  the  full  path  to  the  customized  file(-s)  under  the  mask  of  the 
relevant  package,  e.g.: 
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[hsphere-imap-h2 . 5] 

/ etc/ rc . d/ init . d/ courier-imapd 
/ etc/ rc . d/ init . d/ courier-imapd-ssl 
/hsphere/ local/ conf ig/mail/ imap/e tc/ imapd 
/hsphere/local/ conf ig/mail/ imap/e tc/imapd-s si 

Please  note  that  during  the  package  updates  all  custom  files  will  be  saved  in  the 

/hsphere/local/ conf  ig/ customs/ $package_mask/  directory.  The  default  files 
of  Parallels  H-Sphere  packages,  in  their  turn,  will  be  stored  at 

/hsphere/local/conf ig/customs/def ault/$package_mask/.  The  above 
mentioned  locations  store  the  latest  versions  of  both  custom  and  default  files,  no  matter 
custom  or  default  file  is  being  used. 


Chapter  9 


Appendix  D.  Download  Locations 


This  table  contains  codes  for  all  Linux/FreeBSD  operating  systems  supported  by 
Parallels  Pi-Sphere  and  links  to  the  directories  on  the 

http://download.hsphere.parallels.com  website  where  you  can  download  packages 
required  by  Parallels  Pi-Sphere. 


Operating  System 

OSCODE 

Download  Location 

RedPlat  EL  4,  CentOS 
4.x,  White  Box  EL  4.x 

RHES4 

http : // download. hsphere . parallels . c 

om/shiv/HS/RHES4 

RedPlat  EL  4,  CentOS 
4.x,  White  Box  EL  4.x 
(x86_64) 

RHES464 

http : // download. hsphere . parallels . c 

om/shiv/HS/RHES4  64 

RedPlat  EL  5,  CentOS 
5.x,  CloudLinux  5.5 

RHES5 

http : // download. hsphere . parallels . c 

om/ shiv/HS/RHES5 

RedPlat  EL  5,  CentOS 
5.x  (x86_64) 

RHES564 

http : / / download. hsphere . parallels . c 

om/shiv/HS/RHES5  64 

RedPlat  EL  6,  CentOS 
6.x 

RHES6 

http : // download. hsphere . parallels . c 

om/ shiv/HS/RHES6 

RedPlat  EL  6,  CentOS 
6.x  (x86_64) 

RHES664 

http : // download. hsphere . parallels . c 

om/shiv/HS/RHES6  64 

FreeBSD  7.3 

FBSD73 

http : // download. hsphere . parallels . c 

om/ shiv/HS/FBSD73 

FreeBSD  7.3  (amd64) 

FBSD73  64 

http : // download. hsphere . parallels . c 

om/shiv/HS/FBSD73  64 

FreeBSD  7.4 

FBSD74 

http : // download. hsphere . parallels . c 

om/shiv/HS/FBSD74 

FreeBSD  7.4  (amd64) 

FBSD74  64 

http : // download. hsphere . parallels . c 

om/shiv/HS/FBSD74  64 

In  this  chapter: 

Mirror  Server  for  Updating  Parallels  Pi-Sphere 
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Mirror  Server  for  Updating  Parallels  H- 
Sphere 

If  you  have  2 and  more  boxes  with  the  same  operating  system  and  you  want  to  speed 
up  package  downloads,  you  can  create  a mirror  server  and  in  the  updater  set  an 
alternative  URL  for  package  downloads. 

> To  create  a mirror: 

1 . Set  up  a web  server  (or  just  an  IP-based  virtual  host  in  existing  web 
server). 

2.  In  the  web  server’s  (or  appropriate  virtual  host’s)  document  root 
directory,  create  directory  shiv/HS/releases/U3 6 . 0P3/,  e.g. 
mkdir  -p  /var/www/html/shiv/HS/releases/U36 . 0P3/ 

3.  Download  all  contents  of 

http://download.hsphere.parallels.eom/shiv/HS/releases/U36.0/  into 

your  shiv/HS/releases/U36 . 0P3/  directory. 

4.  Download  the  script 

http : // download . h sphere .parallels . com/ shiv/ HS/ release 
s / sync 3 60 f romPublic . sh,  adjust  it  for  your  paths,  and  run: 
sh  sync360f romPublic . sh 

5.  This  will  download  you  H-Sphere  packages  according  to  the  package 
lists  in  shiv/HS/releases /U3 6 . 0P3/. 


Appendix  E.  Creating  Update  Profiles  for 
Physical  Servers 


Now  you  can  specify  this  mirror  server  to  be  used  by  the  Parallels  H-Sphere 
install/update  script  by  setting  the  mirror  parameter. 
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Physical  server  profiles  are  sets  of  rules  for  updating/installing  physical  boxes.  By 
default,  Parallels  H-Sphere  includes  the  ‘DEFAULT’  profile  which  can’t  be  removed  or 
changed.  If  not  set  otherwise,  the  box  is  updated  according  to  this  DEFAULT  profile. 

You  can  create  your  own  update  profiles  from  the  Parallels  Pi-Sphere  administrator 
interface  and  assign  them  to  specific  boxes.  In  this  case,  the  system  will  update  the 
server  according  to  the  profile  it’s  assigned  to. 

> To  create  a profile: 

1 . Go  to  E.Manager  > Update  > Physical  server  profiles. 

2.  Choose  the  box  (Unix/Windows)  and  click  the  Add  button. 

3.  Name  and  configure  your  profile  in  the  form  that  appears: 

■ Adding  Unix  profile:  with  some  of  the  parameters  refer  to  the  section  on 

hsphere-update  Package  (on  page  37). 

■ Adding  Windows  profile  check  if  needed  the  following  options: 

■ Update  only  pointed  logical  server  groups.  You  can  choose  between  three 
hosting  modes:  Windows  hosting  only,  MsSQL  hosting  only,  or  both 
Windows  and  MsSQL  hosting  modes 

■ Source  URL  for  packages  download  redefinition  is  the  link  to  an  alternative  server 
with  MSI  packages.  If  not  set,  default  MSI  location  is 
http://download.hsphere.parallels.com/shiv/FIS/WINDOWS/. 

■ Location  of  user  home  directory.  If  it  is  not  set  there,  Pi-Sphere  Winbox  installer 
will  automatically  create  it  on  NTFS  partition  with  the  largest  free  space. 

■ MAC  address  of  network  interface  to  host  dedicated  IP’s,  etc.  If  not  set  there,  H- 
Sphere  Winbox  installer  will  automatically  choose  an  address  based  on  the 
free  IPs  of  a physical  server. 

■ Name  of  MSSQL  server  instance.  Give  a name  to  a MsSQL  server  instance  if 
you  want  it  to  differ  from  a default  one  generated  from  a NetBIOS  name  of  a 
specific  server. 

4.  Click  Save  to  apply.  The  newly-created  profile  will  appear  in  the  list  of 
existing  profiles. 

5.  Click  the  Assign  Profiles  to  Physical  Servers  link  to  assign  the  profile  to  a 
server. 

Note:  You  can  assign  only  one  profile  to  a server.  But  one  and  the  same  profile  can 
be  assigned  by  several  servers. 

6.  Check  a physical  box  and  click  Apply. 

> To  reassign  a profile: 

1 . Go  to  E.Manager  > Servers  > P.  Servers. 

2.  Click  the  physical  server  name  you  want  to  reassign  a profile  to. 

3.  Click  the  Edit  icon  in  the  Physical  Server  Profile  field. 
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4.  Reassign  the  profile. 

From  now  on,  every  time  you  update  this  physical  box  from  CP  interface,  it  will  update 
according  to  the  profile. 

In  this  section: 

hsphere-update  Package  Reference 37 
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hsphere-update  Package  Reference 

The  hsphere-update  package  is  installed  during  Parallels  H-Sphere  installation  on 
each  physical  box.  When  updating  Parallels  H-Sphere,  it  runs  the  upackages  script  on 
the  CP  box  to  update  Parallels  H-Sphere  packages  on  each  box  to  their  latest  version. 

upackages  Syntax 

upackages  [ -h  ] [ -i  ] [ -f  ] [ -s  ] [ -v  version  ] [ -V  ] [ -e 

show|add:pattern,...|del:pattern,...|del:all  ] [ -p  ] [ -w  ] [ -m  ] [ -j  ] [-P]  [-r  ] [ -u  ] [ -P  ] [ -n  ] [ 
-M  ] [ -S  ] [ -R  ] [ -N  ] [ -I  ] [ -o  ] 

Where: 

■ h - help  information. 

-i  - ignore  md5  sum  of  the  downloaded  packages,  only  warning. 

-f  - force  mode,  update  packages  by  force,  when  md5  sum  of  the  installed  hsphere 
package  differs  from  downloaded  package. 

-s  - update  only  packages  change,  which  takes  place  in  the  hsphere  subversion 
according  to  corresponding  version. 

-v  version,  format  U[version]/U[subversion],  If  not  specified, 

/hsphere/ shared/ etc/hsversion  file  is  checked. 

-V  - verbose  mode 

-e  - [show|add:pattern1,pattern2,...|del:pattern1,pattern2,...|del:all]  - show,  set 
or  delete  the  list  of  the  package  patterns,  which  must  be  skipped  during  update  on 
all  or  specific  list  of  HS  boxes. 

Note:  Use  this  carefully,  as  HS  packages  are  connected  with  HS  version.  This  may  be 
used  if  you  have  customized  version  of  the  specific  HS  package  or  if  you  update 
system  packages,  like  MySQL  server,  via  native  OS  package  manager,  etc. 

■ p - PostgreSQL  update  (for  new  HS  box  this  is  done  by  default) 

-w  - Site  Studio  update 

-m  - MyDNS  service  is  used  instead  of  Bind  9.3.x,  Update  of  the  bind  will  be 
skipped. 

-j  - required  during  IP  migration 

-r  - package  update  strictly  according  to  package  list  (by  default  update  of  packages 
with  higher  version  skipped) 

-t  [php,httpd,ftpd,mysql,pgsql,cphttpd, named]  - place  custom  templates  in  the 
required  location  for  further  editing 
-P  - update  to  the  latest  SPU  release. 

-u  - Source  URL  for  packages  download  redefinition. 

-n  - Skip  restart  of  postgres  and  httpdcp  at  the  end  of  update. 

-M  - update  modes  (presingle,  hspresingle,  postsingle,  hspostsingle, 
cpinstall,  hsupdate, postgres,  sitestudio,  sitebuilder,  update, 
ipmigration,  deploy): 

■ presingle  - single  server  package  mode 

■ hspresingle  - ‘presingle’  mode,  except  sitestudio  installation 

■ postsingle  - single  server  deploy  mode 
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■ hspostsingie  - ‘postsingle’  mode,  except  sitestudio  postconf 

■ cpinstaii  - control  panel  preinstall  procedure 

■ update  - full  update  (all  packages  update) 

■ hsupdate  - ‘update’  mode,  except  sitestudio  update 

■ postgres  - PostgreSQL  update 

■ sitestudio  - Parallels  SiteStuidio  update 

■ sitebuilder  - Parallels  Presence  Builder  update  (version  3.3+) 

■ ipmigration  - reconfiguring  IP  dependent  information 

■ deploy  - deploy  mode  (general  box  post-reconfiguration) 

■ S - slave  installation/update  mode  - provides  installation/update  of  web  or  mail 
slave  box. 

-R  mask1[,mask2,...]  - revert  mode,  provides  downgrade  of  a set  of  packages  with 
mask1[,mask2,...] 

-N  - this  option  allows  to  force  install/update  for  the  deprecated  OS/soft  listed  in 
http://hsphere.parallels.com/eol.html  if  possible. 

-I  - this  option  allows  to  get  exclude  package  list  from  stdin  (used  in  HS  3.1  for 
different  update  profile  configuration  in  CP  interface).  Retrieved  package  list  is 
merged  with  pre-configured  exclude  package  list. 

-o  - skips  pre-configured  exclude  package  list  during  update. 

For  instance,  to  install  packages  for  Parallels  H-Sphere  3.2  Patch  1 with  md5  sum  of 
the  downloaded  files  ignored  run: 


Appendix  F.  Parallels  H-Sphere  Update 
and  Installation  Script 


upackages  -i  -v  U32.0/U32.0P1 
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Parallels  H-Sphere  administrator  runs  the  same  updater  for  Parallels  H-Sphere 
installation  and  update.  Moreover,  the  updater  is  used  to  update  (and  even  downgrade) 
system  packages  and  configuration  file  templates.  Updater  is  executed  from  the 
corresponding  Parallels  H-Sphere  update  version. 

Parallels  H-Sphere  updater’s  main  features: 

■ Implemented  backward  compatibility,  particularly  for  postgres,  sitestudio, 
ipmigration  keys. 

■ Using  set  of  Parallels  H-Sphere  self-configured  packages,  which  take  IP  dependent 
information  from  the  config.xml  file  with  the  help  of  the  hsinfo  utility. 

■ MD5  sum  check  before/after  package  download. 

■ Update  of  Parallels  H-Sphere  packages  to  the  last  set  of  available  packages, 
allowed  by  specific  Parallels  H-Sphere  version/subversion. 

■ Global  check  of  the  installed  software  after  update  for  each  box. 

■ Possibility  to  add  additional  service/server  after  configuring  them  via  CP  interface. 

■ Check  of  the  required  disk  space  for  installation/update. 

■ Updater  can  be  executed  either  in  the  interactive  (wrapper)  or  in  the  non- 
interactive (update  scipt’s  command  line  interface)  modes. 

■ Update  is  provided  for  all  *nix  physical  servers  in  Parallels  H-Sphere  cluster, 
including  VPS  servers. 

Parallels  H-Sphere  Updater  consist  of  two  parts: 

■ Wrapper  which  checks  and  installs,  if  needed,  the  hsphere-update  package  on 
each  box. 

■ Set  of  update  scripts  installed  as  the  hsphere-update  package. 

Interactive  Mode:  Command  Line  Interface  of  the  Wrapper 

Parallels  H-Sphere  updater’s  interactive  mode  assumes  that  you  first  launch  Parallels 
H-Sphere  update  script,  like  this: 

# sh  <updater_f±lename> 

And  then  type  in  one  of  the  prompted  options  with  or  without  parameter  in  the 
command  line  of  the  form  that  appears. 

See  Parallels  H-Sphere  updater  options. 


Non-Interactive  Mode:  Update  Script’s  Command  Line  Interface 

Parallels  H-Sphere  update  script  can  run  in  non-interactive  mode,  i.e.,  without  the  need 
to  enter  the  wrapper  and  type  in  the  options  there.  Run  the  update  script  with  the 
wrapper’s  options,  like  this: 

# sh  <updater_f±lename>  install  cpinstall 

or: 

# sh  <updater_filename>  update  hspackages  ips =IP1,IP2 

In  this  section: 
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Updating  Parallels  H-Sphere  with  Default  Configuration  Files  Not  Customized  By  Means  of  File  Tempi; 
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Update  Modes  and  Options 

Parallels  H-Sphere  updater/installer  is  downloaded  from  Parallels  H-Sphere  download 
page  located  at  http://www.parallels.com/download/hsphere/  (to  access  the  page,  you 
will  have  to  provide  details  of  your  Parallels  account). 

Run  the  script  with  a corresponding  option.  If  you  run: 

# sh  <updater_f±lename> 

the  script  will  choose  to  update  or  install,  according  to  what  is  available  on  the  server: 

■ CP  Unix  user  cpanel 

■ the  hsphere  . properties  file 

■ consistent  Parallels  H-Sphere  system  PostgreSQL  database 

■ Parallels  H-Sphere  related  software  (if  user  ran  updater  mistakenly  on  a non-CP 
box) 


Important:  It  is  highly  recommended  that  you  run  the  script  with  a specified  update  or 
installation  mode. 


To  update  Parallels  H-Sphere,  run  the  script  in  the  update  mode: 

# sh  <updater_fllename>  update 

You  will  get  the  list  of  update  modes,  each  having  its  own  options: 

(1)  hsupdate  - update  Parallels  H-Sphere  cluster,  except  Parallels  SiteStudio. 

(2)  update  - update  Parallels  H-Sphere  cluster  including  Parallels  SiteStudio. 

(3)  sitestudio  - update  Parallels  SiteStudio  on  the  Control  Panel  box. 

(4)  cpupdate  - update  Parallels  H-Sphere  core  and  related  packages  only. 

(5)  deploy  - Parallels  H-Sphere  cluster  post-update  configuration. 

(6)  hspackages  - Parallels  H-Sphere  cluster  update  in  custom  mode;  additional 
update  options  (forming  custom  configuration  files,  maintaining  exclude  package 
lists,  skipping  CP  update,  etc.) 

(7)  3rdpackages  - install  missing  files  for  Parallels  H-Sphere  .hsp  packages  on 
physical  boxes. 

(8)  revert-downgrade  packages  to  previous  versions. 

(9)  sitebuilder  - update  Parallels  Presence  Builder  on  the  control  panel  server 
(for  Parallels  H-Sphere  3.3  and  up). 

If  you  want  more  information  on  each  mode,  simply  type  its  number  in  the  command 
line. 


Update  Modes: 

■ hsupdate  - common  Parallels  H-Sphere  update,  excluding  system  postgres  and 
Parallels  SiteStudio. 

Options: 
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hsupdate  [ help  ] [ ips=IPl , IP2 , . . ] [ 

group=lgroupl , lgroup2 , . . . ] [ spu  ] [ strict  ] [ nomd5  ] [ 
force  ] [ skip=stage  ] [ url=Link  ] [ mirror=mirror  number  ] 

■ update  - Parallels  H-Sphere  update,  including  system  postgres  and  Parallels 
SiteStudio. 

Options: 

update  [ help  ] [ ips=IPl , IP2 , . . ] [ 

group=lgroupl , lgroup2 , . . . ] [ spu  ] [ strict  ] [ nomd5  ] [ 
force  ] [ skip=stage  ] [ url=Link  ] [ mirror=mirror  number  ] 

■ sitestudio  - Parallels  SiteStudio  update. 

Options: 

sitestudio  [ help  ] [ ips=IPl , IP2 , . . ] [ 

group=lgroupl , lgroup2 , . . . ] [ url=Link  ] [ 

mirror=mirror  number  ] 

■ sitebuilder  - Parallels  Presence  Builder  update  (for  Parallels  H-Sphere  3.3  and 
up). 

Options: 

sitebuilder  [ help  ] [ ips=IPl, IP2, . . ] [ 

group=lgroupl , lgroup2 , . . . ] [ url=Link  ] [ 

mirror=mirror  number  ] 

■ cpupdate  - update  only  Control  Panel  packages,  templates,  jars,  etc. 

Options: 

cpupdate  [ help  ] [ ips=IPl , IP2 , . . ] [ 

group=lgroupl , lgroup2 , . . . ] [ url=Link  ] [ 

mirror=mirror  number  ] 

deploy  - the  so-called  “deploy”  mode  is  run  after  all  the  system  packages  are 
installed/updated.  In  the  deploy  mode  Parallels  H-Sphere  updater  downloads  and 
installs  post-configuration  scripts  that  perform  general  Parallels  H-Sphere  post- 
install/post-update  configuration. 

Options: 

deploy  [ help  ] [ ips=IPl , IP2 , . . ] [ 

group=lgroupl , lgroup2 , . . . ] [ spu  ] [ strict  ] [ nomd5  ] [ 

force  ] [ skip=stage  ] [ url=Link  ] [ mirror=mirror  number  ] 

■ hspackages  - advanced  mode  to  update  Parallels  H-Sphere  related  packages 
across  Parallels  H-Sphere  cluster. 

Options: 

hspackages  [ help  ] [ ips=IPl , IP2 , . . ] [ 

group=lgroupl , lgroup2 , . . . ] 

[ spu  ] [ strict  ] [ nomd5  ] [ force  ] [ skip=stage  ] 

[ reconf ig=f ront-end | spamassassin | all  ] 

[ mode=modename  ] [ oscode  ] [ mirror=mirror  number  ] 

exclude-mysql=show | add | del  | exclude-postgresql=show | add | del 
| exclude-dns=show | add | del  ] 

[ sitestudio  ] [ sitebuilder  ] [ postgres  ] [ url=Link  ] [ 

verbose  ] 

[ ctemplates=php, httpd, ftpd, mysql , pgsql , httpdcp, named  ] 

[ edit=IP : /path/to/custom/template  ] [ skip-exclude  ] 

[ old-platform  ] 
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■ 3rdpackages  - install  missing  files  for  Parallels  H-Sphere  ‘hsp’  packages  on 
physical  boxes. 

3rdpackages  [ help  ] 

This  is  a long  term  operation.  To  examine  the  output  of  the  script  use  tail  -f  logfile 
command. 

■ revert  - downgrade  packages  to  previous  versions. 

Options: 

revert  pkgs= [ list  | package  name, package  name2,..  ] [ help  ] 

Options’  Description: 

■ ips  - only  specific  list  of  the  target  boxes  from  HS  cluster  may  be  pointed  instead  of 
provide  check  update  for  all  IPs  in  HS  cluster; 

■ group  - the  list  of  logical  server  groups,  separated  by  comma.  Possible  groups: 
mail,  web,  dns,  mysql,  pgsql,  cp,  vps  (using  common  ips  and  group  tags  is 
allowed). 

■ spu  - update  to  the  latest  SPU  release. 

■ strict  - form  package  list  based  exclusively  on  package  list.  By  default,  downgrade 
to  older  package  version  is  skipped. 

■ nomd5  - update  is  not  critical  for  wrong  md5  sum,  only  warning; 

■ force  - check  md5  sum  of  the  installed  packages  with  the  same  version  too,  if 
wrong  md5  sum,  install  new  package  by  force; 

■ skip=[check|preparing] 

■ check  - skip  check-up  and  regeneration  of  the  existing  updater. 

■ preparing  - skip  config.xml  regeneration  on  boxes  during  update. 

■ reconfig=front-end|spamassassin|all  - this  option  is  used  in  the  case  of  front-end 
(Horde,  PhpMyAdmin,  PhpPgAdmin)  or  SpamAssassin  database  location 
redefinition.  It  provides  the  list  of  boxes  allocation  where  update  and/or  related 
reconfiguration  is  required. 

■ mode=[hsupdate|update|ipmigration|deploy]  - set  update  mode  with  one  of  the 

options: 

■ hsupdate  - common  update  without  postgres  and  sitestudio; 

■ update  - hsupdate  including  postgres  and  sitestudio; 

■ ipmigration  - reconfiguring  IP  dependent  information; 

■ deploy  - deploy  mode  (post-install  general  box  reconfiguration). 

■ oscode  - shows  OS  code  of  each  box  during  update  preparation. 

■ mirror  - allow  to  set  another  mirror  instead  of  the  default  one.  At  this  moment 
available  are  the  following  Parallels  H-Sphere  servers: 

0 download.hsphere.parallels.com  (USA)  default 

1 download2.hsphere.parallels.com  (Europe) 
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■ exclude-mysql=show|add|del  | exclude-postgresql=show|add|del  | exclude- 
dns=show|add|del  - you  can  configure  Parallels  H-Sphere  to  use  custom 
PostgreSQL/MySQL  versions  instead  of  installing  their  default  versions  (read  more 
in  the  section  Configuring  H-Sphere  to  Use  Non-Default  MySQL/PostgreSQL 
Versions  of  Parallels  H-Sphere  System  Administrator  Guide).  In  this  case  HS 
updater  allows  excluding  related  package  from  the  Parallels  H-Sphere  update 
leaving  the  possibility  to  update  them  via  native  system  package  managers. 
Example: 

hspackages  exclude-mysql=add  ips=192 . 168 . 1 . 10 

the  exciude-dns=  option  allows  to  exclude  standard  Bind  server  in  order  to  use 
MyDNS  server  or  other  custom  DNS  servers  (like  djbdns,  http://cr.yp.to/dibdns.html) 
instead.  More  in  the  section  MyDNS  Installation  and  Configuration  of  Parallels  H- 
Sphere  System  Administrator  Guide. 

■ skip-exclude  - skip  pre-configured  exclude  package  list  during  current  update.  Skip 
pre-defined  exclude  list  that  was  previously  set  via  exclude 

■ sitestudio  - update  Parallels  SiteStudio  to  the  last  supported  version. 

■ sitebuilder  - update  Parallels  Presence  Builder  to  the  last  supported  version 
(Parallels  H-Sphere  3.3+). 

■ postgres  - update  postgressql  to  the  last  supported  version. 

■ url=Link  - alternative  path  for  package  download  (instead  of 
http://download.hsphere.parallels.com/shiv/HS); 

■ verbose  - inform  whether  package  was  installed  by  force  or  with  nodeps; 

■ ctemplates=php,httpd,httpd2,cphttpd,httpd_extra,httpd2_extra,cphttpd_extra, 
ftpd,mysql,pgsql, named  - Place  custom  configuration  file  templates  for  comma- 
separated  list  of  services  into  predefined  locations  if  custom  templates  are  not  there 
already. 

the  httpd_extra,  httpd2_extra,  and  cphttpd_extra  options  are  used  to 
customize  some  extra  configuration  files  respectively  for  Web  server’s  Apache  1 .x 
and  2.x  and  for  CP  Apache.  Also  the  httpd2  option  is  introduced  for  Apache  2.2. 

■ edit=IP:/path/to/custom/template  - edit  custom  configuration  file  template  on  a 
specified  server  in  a specified  location. 

■ old-platform  - this  option  allows  to  force  install/update  for  the  deprecated  OS/soft 
listed  in  http://hsphere.parallels.com/eol.htmll. 

■ subversion  - there  is  global  hsphere  package  list  and  its  subversion  differences. 

■ help2  - get  additional  possibilities  description.  This  key  allow  to  check  only 
subversion  check  to  speed  up  update  (of  course,  update  to  corresponding  hsphere 
version  is  required  before); 

■ slaves=web|mail|all  - choose  this  option  to  install/update  packages  on  slave 
servers  of  load  balanced  Web/mail  clusters.  More  in  the  section  Installation  of  Load 
Balanced  Web/Mail  Clusters  of  Parallels  H-Sphere  System  Administrator  Guide. 

■ help2  - get  description  of  additional  possibilities  description.  This  key  allow  to  check 
only  subversion  check  to  speed  up  update  (of  course,  update  to  corresponding 
hsphere  version  is  required  before); 
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pkgs=[  list  | package_name1  ,package_name2,..  ] - revert  (downgrade)  packages 
separated  by  comma.  For  example:  revert=hsphere- 
webmails , mysql , hsphere-mnogo search 

Using  pkgs=list  will  display  the  list  of  all  packages  you  can  downgrade.  Choose  from 
the  list. 
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Selective  Update  of  Parallels  H-Sphere 
*nix  Packages 

If  you  have  customized  versions  of  Parallels  H-Sphere  *nix  packages  or  other  system 
packages  that  you  update  via  native  OS  package  manager,  you  need  to  exclude  them 
from  being  updated  by  the  script.  Parallels  H-Sphere  update  in  this  case  should  be  run 
as  follows: 

1.  Update  Parallels  H-Sphere  core  (templates,  classes,  jars): 

cpupdate  [OPTIONS] 

2.  To  exclude  the  packages,  type: 
hspackages  [ ips=</Pf> ,<IP2> , . . .<IPN>] 

exclude=add  :<pattern1>  ,<pattern2> , . . .<patternN>  skip=preparing 

Here,  <IPx>  are  physical  server  IPs,  and  <patternx>  are  packages  to  exclude.  For 
detailed  syntax  see  command  line  interface  of  the  Parallels  H-Sphere  Updater 
wrapper. 

To  make  sure  you  have  successfully  excluded  the  packages,  run: 

hspackages  [ ips=</Pf>,</P2>,  . . .<IPN>]  exclude=show 
skip=preparing 

Warning:  Please  be  very  careful  in  excluding  the  packages  from  the  update  list! 
You  must  have  serious  reasons  to  do  this! 

3.  Update  Parallels  H-Sphere  related  packages: 

hspackages 


Note:  If  you  update  Parallels  H-Sphere  packages  from  the  interface,  you  can  exclude 
the  above  mentioned  packages  from  the  update  by  checking  the  Exclude  package 
list  option  in  the  physical  server  profile  (on  page  34). 


Updating  Parallels  H-Sphere  with  Default 
Configuration  Files  Not  Customized  By 
Means  of  File  Templates 

1.  Update  Parallels  H-Sphere  core  (templates,  classes,  jars): 

cpupdate  [OPTIONS] 

2.  To  create  default  configuration  file  templates,  type: 

hspackages  ctemplates=php ,httpd, f tpd,mysql ,pgsql 
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For  syntax  and  details  please  read  about  customizing  configuration  files  by  means 
of  templates  (on  page  17). 

Important:  This  command  will  create  default  configuration  file  templates  in 
respective  directories.  After  that,  you  should  customize  them  according  to  the 
custom  configuration  you  had  before.  Typical  reasons  for  such  customization  may 
be  the  use  of  Zend  Optimizer,  ChiliASP,  ColdFusion  Apache  modules,  etc. 

3.  Update  Parallels  H-Sphere  related  packages: 

hspackages 


